package com.zzedu.integration.oss;

import com.zzedu.integration.oss.dto.FileInfoDTO;
import com.zzedu.integration.oss.dto.OssFileResult;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * minio服务
 */
public interface IOssClientService {
    /**
     * 删除文件
     *
     * @param bucketName bucket名称
     * @param objectName 文件名称
     * @throws Exception https://docs.minio.io/cn/java-client-api-reference.html#removeObject
     */
    public OssFileResult removeObject(String bucketName, String objectName);

    /**
     * 上传文件
     * @param file 文件
     * @param dir  目录
     * @param reFileName 文件名称,不包括文件后缀
     * @return
     */
    public OssFileResult<FileInfoDTO> uploadFile(MultipartFile file, String dir,String reFileName);

    /**
     * 上传文件
     * @param dir 目录
     * @param allPathFileName 本地全路径
     * @return
     */
    public OssFileResult<FileInfoDTO> uploadFile(String dir, String allPathFileName);

    public OssFileResult<FileInfoDTO> uploadFile(String dir, String allPathFileName,String reFileName);
    /**
     * 上传文件
     *
     * @param file 文件
     * @return
     */
    public OssFileResult<List<FileInfoDTO>> uploadFile(List<MultipartFile> files, String dir);

    /**
     * 获取访问地址
     *
     * @param objectName  默认过期时间1周
     * @return
     */
    public String convertURL(String objectName);
    /**
     * 获取访问地址
     * @param domain 地址前缀
     * @param objectName 资源名称
     * @return
     */
    public String convertURL(String domain,String objectName);
    /**
     *
     * @param objectName 对象名称
     * @param expire 过期时间 毫秒
     * @return
     */
    public String convertURL(String objectName,long expire);

    /**
     * 删除文件
     *
     * @param objectName 文件名称
     */
    public OssFileResult removeObject(String objectName);

    /**
     * 删除文件[真实删除oss]
     *
     * @param objectName 文件名称
     */

    public OssFileResult deleteObject(String objectName);
    /**
     * 下载对象
     * @param objectName
     * @return
     */
    public byte[]  download(String objectName);

    /**
     * 文件是否存在
     * @param objectName
     * @return
     */
    public boolean doesObjectExist(String objectName);

    /**
     * 获取oss 访问前缀
     * @return
     */
    public String ossDomain();
}
